home *** CD-ROM | disk | FTP | other *** search
/ Megahits 3 / Megahits 3 (1994)(GTI - Rhein-Main-Soft)(DE)[!].iso / denkspiele / amancala / english / amancala.doc < prev    next >
Text File  |  1994-10-14  |  17KB  |  382 lines

  1.  
  2.                       A M A N C A L A   V   1 . 1 9
  3.                       =============================
  4.  
  5.                            Thorsten Koschinski
  6.                                Meisenweg 10
  7.                              W-2082 Uetersen
  8.                                  Germany
  9.  
  10.  
  11.  
  12.  
  13.                                1. COPYRIGHT
  14.  
  15.          AMancala V1.19 (C) Thorsten Koschinski 1991. All rights
  16.          reserved. Except for Requester.Library V 2.5 and all it
  17.          concerning files (C) Colin Fox and Bruce Dawson 1989.
  18.  
  19.             AMancala V1.19 is a reduced demo version of the ori-
  20.          ginal Shareware  program. This  means that you can copy
  21.          it freely as long as you respect the following rules :
  22.             
  23.                1. No fee is  charged for the distribution
  24.                   of this package (except for postage and
  25.                   costs for magnetic media).
  26.                2. The program  and all files  belonging to
  27.                   it  remain in their  original unmodified
  28.                   form.
  29.                3. The package is  always and only disribu-
  30.                   ted in its complete form.
  31.  
  32.  
  33.                              2. DISTRIBUTION
  34.  
  35.          All releases of AMancala  higher than V 1.19 are Share-
  36.          ware. These  versions can  be obtained  directly by the
  37.          author by discharging a fee. This charge amounts to $20
  38.          for  Western  Europe and  $25 for  all other countries.
  39.          Also all other  saleable international  currencies will
  40.          be accepted, so far as  the amount equals to the actual
  41.          official  rule of  exchange  of the  dollar. Additional
  42.          costs for postage dropped.
  43.  
  44.             Each so recorded user gets the newest release of the
  45.          program including a detailed manual on disc and becomes
  46.          a registered  user. We offer an  update service for one
  47.          year to all registered users.
  48.  
  49.  
  50.                               3. DISCLAIMER
  51.  
  52.          Although every  effort has been made to  have a correct
  53.          function  depending on  the description  in the manual,
  54.          the author is not responsible for any damage the use of
  55.          this  program  does and  expresses no  warranty on  the
  56.          faultlessness of the game and the whole package.
  57.  
  58.             You are  entirely responsible on  your own  risk for
  59.          all things  sustained by the legal use or misuse of the
  60.          files containing this package.
  61.  
  62.  
  63.                              4. REQUIREMENTS
  64.  
  65.          AMancala V1.19 runs on all Amiga  models with  at least
  66.          512k byte of memory. The precise usage of memory in the
  67.          english  version amounts to 269048 byte Chip memory and
  68.          35280 byte Fast memory. The program runs as well on the
  69.          Workbench (start by  clicking the AMancala  icon) as on
  70.          CLI (input the name AMancala). As additional  files the
  71.          delivered  fonts and the file  req.library are required
  72.          (see also Installation).
  73.  
  74.             When  using  AMancala  with  other  applications  in
  75.          multitasking  mode you take  notice that, depending  on
  76.          the use  of functions  from the  Requester.Library, all
  77.          system requester will appear on the AMancala screen.
  78.  
  79.  
  80.                              5. INSTALLATION
  81.  
  82.          Bevor you  start the game it is  necessary to install a
  83.          couple of required files. This  work is done by a batch
  84.          file. This  file installs two new  fonts in the logical
  85.          device FONTS: so far as they do not exist.
  86.  
  87.             It concerns  the fonts Sapphire  with the size of 19
  88.          and AMancala  with the size of 16. In  addition to this
  89.          the file req.library is  established in the logical de-
  90.          vice LIBS:. The installation must  be done only for one
  91.          time.
  92.  
  93.             You  can choose  between an installation from  Work-
  94.          bench (clicking the Install icon) or from  the CLI (In-
  95.          put : Install<RETURN>).
  96.  
  97.  
  98.                                6. THE GAME
  99.  
  100.          AMancala, originally  Mankalla [ arab. : naqala  = move
  101.          away, displace ] is a  boardgame, which is  wide-spread
  102.          in Africa, S-, SE-, and W.-Asia as well as in W.-India.
  103.          Originally it  was played on a simple board or  with in
  104.          the ground imbedded  holes. In addition to the original
  105.          name the game is also known under numerous other desig-
  106.          nations, i.e. ManqalaMinqalaMbao or Warri. The lat-
  107.          ter two  names  denote towns  sited in Africa, in which
  108.          the game  probably  originated or at least  got a great
  109.          propagation.
  110.  
  111.             Mbao [ frc. mba'o ], is a town in the north  eastern
  112.          suburb  region of Dakar in  Senegal. Warri is a seaport
  113.          in Nigeria, sited in the western delta of the Niger Ri-
  114.          ver 80 km SSE of Benin City.
  115.  
  116.             In the  history  of  origins also  the tribe  of the
  117.          Baga, which  is dominiciled at the coast of Guinea nor-
  118.          thern from  Conakry, emerges again and  again. The mem-
  119.          bers of this tribe could be supposed to be the creators
  120.          of the game.
  121.  
  122.             The African originators played Mankalla  with 6 sto-
  123.          nes in each  field. Possible  are also  variations with
  124.          more or less stones  per field. 3 or less  stones don't
  125.          make any sense, because therefor exist guaranteed stra-
  126.          tegies of  victory. Conceivable are also  variants with
  127.          more fields for each player or with more than two play-
  128.          ers.
  129.  
  130.  
  131.                            7. RULES OF THE GAME
  132.  
  133.          The below  listed  rules of the AMancala implementation
  134.          differ in 2 details from the original. These  modifica-
  135.          tions  will be listed at the end of the  description of
  136.          the rules  and the  reason for this  deviation  will be
  137.          outlined.
  138.  
  139.             Each  player owns  6 fields  with 6 stones  on  each
  140.          field and a so called Khala, where you  have to collect
  141.          stones. The  6 fields  are comprehensive and  clockwise
  142.          grouped at the long side of the  board. The  Khala fol-
  143.          lows in  the sequence  after the  6. field. The players
  144.          perform their moves alternately. A move consists of the
  145.          choice of one from your own 6 fields (by clicking  with
  146.          the  left  mouse  button). The  stone  this  field, the
  147.          source, contains  will be removed from it and distribu-
  148.          ted among the other fields.
  149.  
  150.          This happens as follows :
  151.          The  distribution   happens  solitary  clockwise.  This
  152.          means, that  each  field, sited  to  the  right  of the
  153.          source, is additionally filled  with one stone, respec-
  154.          tively, until all stones taken from the source are con-
  155.          sumed. Thus, the  distribution  covers  first  the  own
  156.          fields, following  the own Khala, the  opposing  fields
  157.          and again the  own fields. It is possible, depending on
  158.          the number of taken stones, to walk through the playing
  159.          field more than  once, so that  some  fields, including
  160.          the source, could  get more  than one additional stone.
  161.          Decisive for now is, in  which field the last stone was
  162.          placed.
  163.  
  164.          Three cases are to distinguish :
  165.  
  166.            1. Last stone in own Khala --> Move complete.
  167.  
  168.            2. Last stone in own fields --> Clear this  field and
  169.               distribute all containing stones as shown above at
  170.               the fundamental  move. With  this  possibility one
  171.               can attain an arbitrary long chain of moves.
  172.  
  173.            3. Last  stone in an opposing field --> In this  case
  174.               it exists the  possibility to  plunder stones  for
  175.               your Khala. And that by the following procedure :
  176.               Outgoing from the field, in  which a stone is pla-
  177.               ced  at last, one looks at  the adjacent  field in
  178.               decreasing  direction (so  far as it  exists). Are
  179.               there 2 or 3 stones, they will be removed and pla-
  180.               ced in the own Khala. Subsequently one handles the
  181.               same with the next field in decreasing order. Sto-
  182.               nes will be removed as long as the inspected field
  183.               contains 2 or 3 stones or  no field  with a  lower
  184.               number exists.
  185.  
  186.          The winner is, who
  187.  
  188.             - first  has collected  more than  36 stones in  his
  189.               Khala.
  190.  
  191.             - has no stone left in all his  fields (in this case
  192.               he gets all stones placed in the fields of his op-
  193.               ponent, too).
  194.  
  195.             Finally we discuss, as  mentioned above, the two mo-
  196.          difications from the original rules.
  197.  
  198.             The first modification affects the linkage of moves.
  199.          After the last stone is placed in a field of the moving
  200.          player, all this field containing stones can, depending
  201.          on the in this  version implemented  rules, be  removed
  202.          and  distributed  among the other  fields. The original
  203.          limits this  variant in so  far as that  during a  move
  204.          stones must have been layed up at the opposing side. By
  205.          this, in  my  opinion, the tactical  freedom of  action
  206.          will be dramatically restricted. Also the original rule
  207.          offers the moving  player less possibilities to protect
  208.          fields, which are low on stones, from  capturing by the
  209.          opponent. Moreover the final stage would  degenerate to
  210.          a tedious  moving of single stones  without leaving the
  211.          possibility to the behindhand player to repair his lag.
  212.  
  213.             The second modification affects the capturing of op-
  214.          posing  stones. In  the  original it is  provided, that
  215.          stones can be already captured from the field, in which
  216.          the last stone  was distributed. This rule  would allow
  217.          to clear  all fields of the opponent in one  move. This
  218.          success  however  is  misleading, because  such a  move
  219.          would only lead to victory, if it is sufficient to con-
  220.          centrate  more than the half of all  stones in the  own
  221.          Khala. If  this  is  not the case, the  opponent wins -
  222.          without doing  anything  productive - on his next move,
  223.          since indeed all his fields  are empty. One could think
  224.          that it is in the responsibility of the player to avoid
  225.          such a  situation, but still a beginner  should be pro-
  226.          tected  from such 'unlogical' situations  by the rules.
  227.          That is why in this  implementation the field, in which
  228.          a stone is placed at last, is locked from capturing, so
  229.          that at least one field  remains filled. By  this it is
  230.          not complete  ensured, too, that the  capturing  player
  231.          becomes a game decisive disadvantage (suppose that only
  232.          field no. 6 remains with less than 8 stones. These sto-
  233.          nes could  be  distributed to  gain the  victory in the
  234.          following  move on  the  own  Khala  and  the  opposing
  235.          fields, so that the own  fields remain empty), this me-
  236.          thod however ensures  rather a course of the  game con-
  237.          curring with the rules.
  238.  
  239.  
  240.                             8. ERROR MESSAGES
  241.  
  242.          If the program  finds an  environment, in  which it can
  243.          not be  run, it ends and  prints out a short error mes-
  244.          sage, which  will be sufficient in most cases to elimi-
  245.          nate  the  incorrect  situation. The  essential  faults
  246.          arise  when  there  is a  lack of  memory, libraries or
  247.          other files.
  248.               
  249.             The most frequently arising faults  depend on an ab-
  250.          sence  of a preceding  installation as  described at 5.
  251.          Here  now a condensed  collection of all existing error
  252.          messages :
  253.  
  254.          a. Can't open Req.Library
  255.             The program  can't find the Requester.Library in the
  256.             logical device LIBS:. Probably the  installation has
  257.             not been done until now or  proceeds in an incorrect
  258.             manner.
  259.  
  260.          b. Can't open Intuition.Library
  261.             This error  should never  happen, because the  Amiga
  262.             operating  system  serves that the Intuition-Library
  263.             stays always resident in memory.
  264.  
  265.          c. Can't open Graphics.Library
  266.             Also this error should never occur, because the Ami-
  267.             ga operating system  handles the Graphics-Library in
  268.             the same manner as the Intuition-Library.
  269.  
  270.          d. Can't open DiskFont.Library
  271.             The DiskFont.Library  doesn't  exist in  the logical
  272.             device  LIBS:. This  file may  be included on  every
  273.             original Workbench disc and can be copied  from here
  274.             to your system disc or harddisc.
  275.  
  276.          e. Can't open Screen
  277.             The reason  for the occurence of  this error message
  278.             is a  critical lack of memory. Clean the  RAM memory
  279.             of your Amiga until you get enough memory as descri-
  280.             bed at 4.
  281.  
  282.          f. Can't open AMancalaWindow
  283.             see e.
  284.  
  285.          g. Can't open ProtocolWindow
  286.             see e.
  287.  
  288.          h. Can't open WarningWindow
  289.             see e.
  290.  
  291.          i. Can't find AMancala-Font
  292.             The AMancala font with the size of 16 doesn't  exist
  293.             in the logical device FONTS:. Probably the installa-
  294.             tion has not been done  until now or  proceeds in an
  295.             incorrect manner.
  296.  
  297.          j. Can't find Sapphire-Font
  298.             The Sapphire font with the size of 19 doesn't  exist
  299.             in the logical device FONTS:. Probably the installa-
  300.             tion has not been done  until now or  proceeds in an
  301.             incorrect manner.
  302.  
  303.          k. Can't find Topaz-Font
  304.             The Topaz font  with the size of 8 wasn't found. Un-
  305.             til including  Kickstart 2.0 this font  should  stay
  306.             resident in memory.
  307.  
  308.          l. No memory for AMancalaWindow background area
  309.             see e.
  310.  
  311.          m. Can't attach temporary RastPort for AMancalaWindow
  312.             see e.
  313.  
  314.          n. No memory for ProtocolWindow background area
  315.             see e.
  316.  
  317.          o. Can't attach temporary RastPort for ProtocolWindow
  318.             see e.
  319.  
  320.          p. No memory for WarningWindow background area
  321.             see e.
  322.  
  323.          q. Can't attach temporary RastPort for WarningWindow
  324.             see e.
  325.  
  326.  
  327.                                 9. MANUAL
  328.  
  329.          For  this demo  version no  manual exists. Nevertheless
  330.          the online manual of the game should supply  enough in-
  331.          formation.
  332.  
  333.             However the obtainable Shareware releases  enclose a
  334.          comprehensive, all  details  explanatory  manual, which
  335.          will be supplied on disc.
  336.  
  337.  
  338.                              10. LIMITATIONS
  339.  
  340.          The release 1.19  belonging to this document contains a
  341.          slightly reduced set of functions compared with the ac-
  342.          tual Shareware release. The main difference is the loss
  343.          of the possibility to save and print protocols.
  344.  
  345.             Also the game will be afflicted in continually shor-
  346.          ten distances by distasteful pauses, which will getting
  347.          longer with increasing duration of the game. 
  348.  
  349.             At this it is  not a matter of chicanery against the
  350.          user, neither the gambling fever should be reduced, but
  351.          it is necessary to adhere the idea of Shareware.
  352.  
  353.             The Shareware package proper additionally contains a
  354.          from the game separated  program, to view and print out
  355.          protocols independent from this.
  356.  
  357.  
  358.                          11. FUTURE IMPROVEMENTS
  359.  
  360.          For  the  releases 1.2x  published  approximately  from
  361.          September 1992  we have  planed  some enhancements. For
  362.          the first  time environment  variables  will be used to
  363.          self configure the  program in several  places. Adjust-
  364.          able should  be for instance the colors, the directory,
  365.          which contains the file with the ranking lists, the ex-
  366.          tention of the protocol files and some things more.
  367.  
  368.             Furthermore additional icons  will be produced, when
  369.          saving  a protocol. An  independent program  serves for
  370.          viewing at and printing out protocols  without the help
  371.          of the main program.
  372.  
  373.             For use of the game with faster Amiga models (A3000,
  374.          Turboboards) the number of playable computer types will
  375.          be adequate extended.
  376.  
  377.             Also possible is an enhancement about a playing mode
  378.          depending on the original rules. Whether this mode will
  379.          be offered  alternatively or  will replace the  current
  380.          one is not decided until now.
  381.  
  382.